package com.ithailong.reconsitutionmassion.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * author:hlc
 * date:2023/10/23
 * @author 17930
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {
   /**
    * 创建API应用
    * apiInfo() 增加API相关信息
    * 通过select()函数返回一个ApiSelectorBuilder实例,用来控制哪些接口暴露给Swagger来展现，
    * 本例采用指定扫描的包路径来定义指定要建立API的目录。
    *http://localhost:9000/swagger-ui.html接口访问地址
    * @return
    */
   @Bean
   public Docket restApi() {
      return new Docket(DocumentationType.SWAGGER_2)
              .groupName("标准接口")
              .apiInfo(apiInfo("文件管理API", "1.0"))
              .useDefaultResponseMessages(true)
              .forCodeGeneration(false)
              .select()
              .apis(RequestHandlerSelectors.basePackage("com.ithailong.reconsitutionmassion.controller"))
              .paths(PathSelectors.any())
              .build();
   }

   /**
    * 创建该API的基本信息（这些基本信息会展现在文档页面中）
    * 访问地址：http://localhost:8080/swagger-ui.html
    *
    * @return
    */
   private ApiInfo apiInfo(String title, String version) {
      return new ApiInfoBuilder()
              .title(title)
              .description("更多请关注: https://mp.csdn.net/mp_blog/manage/article?spm=1001.2101.3001.5448")
              .termsOfServiceUrl("https://mp.csdn.net/mp_blog/manage/article?spm=1001.2101.3001.5448")
              .contact(new Contact("xqnode", "https://mp.csdn.net/mp_blog/manage/article?spm=1001.2101.3001.5448", "xiaqingweb@163.com"))
              .version(version)
              .build();
   }
}
